Wanderbar SNES v1.0 by Clyde "Tomato" Mandelin
http://tomato.fobby.net/wanderbar



Usage Notes & FAQs:

	- The specified sidebar plugin loads automatically when you load a game
	
	- To switch to a different sidebar, close the emulator completely,
	  edit "setup.txt" to point to the new plugin, re-run the emulator, and
	  load a game. All the default scripts are called "main.lua" so you
	  really just need to change the directory name in "setup.txt".
	  
	- Screenshot types can be chosen from the sidebar menu. When taking
	  screenshots that include the sidebar, be sure there aren't any other
	  windows covering the game window or the sidebar window at the time.
	  
	- I designed this software for my personal use, so I can't guarantee that
	  it will work on your computer or that it will run smoothly for you.
	  
	- I lack the skills and knowledge to make a Mac version, but I've
	  provided the source code in case a more skilled programmer wants to try.
	  

	
Creating Your Own Plugins:

I designed the Wanderbar to be easy to program for and easy to design nice
interfaces for. There are two main parts to making a plugin:

	- a Lua script that handles all the main logic and keeps tabs on the
	  emulated game every emulated CPU cycle
	  
	- the sidebar part, which is just basic HTML
	
Of course, the sidebar allows anything that a normal webpage would allow,
so you can use Javascript libraries like jQuery, external web APIs,
CSS3 stylesheets, HTML5, and more.

Note that the sidebar browser is completely separate from whatever browser
you normally use. It's its own individual browser. It's based on an old
version of Chromium (version 18 I believe), so not all of the latest web
technology works. Javascript-based voice synthesis, for example, isn't
supported. I'd like to move away from this version and use something more
recent, but the Awesomium SDK is no longer supported and probably won't see
any more updates.

Also note that the Wanderbar's browser allows for local file storage. This
is necessary and helpful for things like my RikaiWTF plugin that require
loading external data files, but it also means that the Wanderbar browser
is potentially less secure than standard browsers and shouldn't be used
for standard web browsing. I don't know why anyone would do that anyway,
though.

I'll eventually provide documentation on how the plugins work, but just a
quick look through any of the default plugins should explain most of it.



==============================================================================
LICENSE INFORMATION
==============================================================================

Wanderbar SNES License Information

This file is part of Wanderbar SNES.

Wanderbar SNES is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

Wanderbar SNES is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with Wanderbar SNES. If not, see <https://www.gnu.org/licenses/>

==============================================================================

Snes9x - Portable Super Nintendo Entertainment System (TM) emulator.

Snes9x homepage: http://www.snes9x.com/

Permission to use, copy, modify and/or distribute Snes9x in both binary
and source form, for non-commercial purposes, is hereby granted without
fee, providing that this license information and copyright notice appear
with all copies and any derived work.

This software is provided 'as-is', without any express or implied
warranty. In no event shall the authors be held liable for any damages
arising from the use of this software or it's derivatives.

Snes9x is freeware for PERSONAL USE only. Commercial users should
seek permission of the copyright holders first. Commercial use includes,
but is not limited to, charging money for Snes9x or software derived from
Snes9x, including Snes9x or derivatives in commercial game bundles, and/or
using Snes9x as a promotion for your commercial product.

The copyright holders request that bug fixes and improvements to the code
should be forwarded to them so everyone can benefit from the modifications
in future versions.

Super NES and Super Nintendo Entertainment System are trademarks of
Nintendo Co., Limited and its subsidiary companies.

-------------------------------------------------------------------------------

Some parts included in Snes9x are usually available under a different license,
their authors have granted exception for their use in Snes9x (and/or they are
licensed as LGPL):
 - JMA: GPL/LGPL, see jma/license.txt
 - GTK port: dual licensed as LGPL, see gtk/doc/LICENSE
 - snes_ntsc: LGPL, see filter/snes_ntsc-license.txt
 - xBRZ: GPLv3, see filter/xbrz-license.txt
 
==============================================================================

LuaBridge License Information
https://github.com/vinniefalco/LuaBridge
 
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.

==============================================================================

If you're reading this let me know
 
==============================================================================

Awesomium.Net License Information
https://archive.codeplex.com/?p=awesomium

Licensing:
Awesomium and Awesomium.NET are free for evaluation, non-commercial use, and
independent use (by companies who made less than $100K in revenue last year).

==============================================================================

jQuery License Information

Copyright JS Foundation and other contributors, https://js.foundation/

Permission is hereby granted, free of charge, to any person obtaining
a copy of this software and associated documentation files (the
"Software"), to deal in the Software without restriction, including
without limitation the rights to use, copy, modify, merge, publish,
distribute, sublicense, and/or sell copies of the Software, and to
permit persons to whom the Software is furnished to do so, subject to
the following conditions:

The above copyright notice and this permission notice shall be
included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

==============================================================================

Rikaikun License Information

The "rikaiwtf" script used in some sidebar plugins is based on the Rikaikun
browser plugin.

Rikaikun
Copyright (C) 2010 Erek Speed
http://code.google.com/p/rikaikun/

---

Originally based on Rikaichan 1.07
by Jonathan Zarate
http://www.polarcloud.com/

---

Originally based on RikaiXUL 0.4 by Todd Rudick
http://www.rikai.com/
http://rikaixul.mozdev.org/

---

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA